Contexto global

ReadJSON

Sintaxis:

ReadJSON(<JSONReader>, <LeerAMapa>, <NombresPropiedadesConValoresFecha>, <FormatoFechaEsperado>, <NombreFuncionRevivir>, <ModuloFuncionRevivir>, <ParametrosAdicionalesFuncionRevivir>, <NombresPropiedadesRecuperar>, <NivelAnidamientoMaximo>)

Parámetros:

Tipo: JSONReader.
Objeto lector de JSON

Tipo: Boolean.
Si se marca como Verdadero, el objeto JSON se leerá en un Mapa.
Si se marca como Falso, los objetos se leerán en un objeto de tipo Estructura.
Nota. Preste atención a los requisitos de las claves de estructura al deserializar objetos JSON en una estructura. Se genera una excepción si se encuentra un nombre de propiedad no permitido para una clave de estructura durante la deserialización del objeto.
Valor predeterminado: Falso.

Tipo: Array, String, FixedArray.
Array cuyos elementos contienen nombres de propiedades JSON.
Para las propiedades especificadas, se llamará a la restauración de fecha a partir de una cadena según el formato especificado en el parámetro FormatoFechaEsperado.
Si el nombre de la propiedad se especifica en este parámetro y se especifica en el parámetro NombresPropiedadesRecuperar, estas propiedades se restauran con la función de restauración.
Si no es posible restaurar la fecha a partir del valor de la propiedad, se genera una excepción.
Valor predeterminado: Indefinido.

Tipo: JSONDateFormat.
El formato de fecha previsto durante la deserialización de objetos en formato JSON.
Se genera una excepción si el valor resultante de la deserialización no es una cadena y tiene un formato de fecha diferente al previsto.
Valor predeterminado: ISO.

Tipo: String.
Esta función se llama cada vez que se lee una propiedad. Debe tener los siguientes parámetros:

• <Propiedad>. Tipo String. Especifíquelo solo para leer objetos JSON.
• <Valor>. Un valor de un tipo serializable.
• <ParametrosAdicionales>.

El valor de retorno tiene un tipo arbitrario.
Si se establece este parámetro y no se establece <ModuloFuncionRevivir> (o viceversa), se genera una excepción.
Si no se establece la función, se ignora el parámetro <NombresPropiedadesConValoresFecha> o el método ReadJSON.
Valor predeterminado: Indefinido.

Tipo: Arbitrario.
Especifica el módulo cuyo procedimiento se utilizará para la restauración del valor.
Valor predeterminado: Indefinido.

Tipo: Arbitrario.
Parámetros adicionales que se transferirán a la función de recuperación del valor.
Valor predeterminado: Indefinido.

Tipo: Array.
Array de nombres de propiedades JSON para los cuales se llamará a la función de recuperación.
El parámetro se ignora si no se establece el parámetro NombreFuncionRevivir.
Valor predeterminado: Indefinido.

Tipo: Number.
El nivel máximo de anidamiento de un objeto JSON.
Si se supera el nivel anidado, se genera una excepción.
Valor predeterminado: 500.

Valor devuelto:

Tipo: Arbitrario.

Descripción:

Lee el valor de un texto JSON o de un archivo. El texto JSON debe ser válido.

Disponibilidad:

Cliente ligero, servidor, cliente grueso, conexión externa, aplicación móvil (cliente), aplicación móvil (servidor), servidor independiente móvil, Integración.

Nota:

Un array se deserializará en un array. Un objeto JSON se transformará en un mapeo o una estructura (si la clave de estructura no es válida, se generará una excepción).
Para las fechas, es similar al método ReadJSONDate.
Se puede llamar a una función personalizada para recuperar el valor durante la ejecución del método. Para hacerlo, use el parámetro <NombreFuncionRevivir>. La función de recuperación debe estar descrita con las directivas &OnServer o &OnClient. No se permite el uso de la función fuera del contexto.

Disponible desde:

Disponible desde la versión 8.3.6.

Descripción cambiada en la versión 8.3.23.